package com.uniflow.mapper;

import com.uniflow.entity.UserPermission;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 用户权限数据访问层
 * 
 * @author luban
 * @since 1.0.0
 */
@Mapper
public interface UserPermissionMapper {
    
    /**
     * 根据ID查询用户权限
     */
    UserPermission selectById(@Param("id") String id);
    
    /**
     * 根据用户ID查询权限列表
     */
    List<UserPermission> selectByUserId(@Param("userId") String userId);
    
    /**
     * 根据权限ID查询用户列表
     */
    List<UserPermission> selectByPermissionId(@Param("permissionId") String permissionId);
    
    /**
     * 根据用户ID和权限ID查询关联
     */
    UserPermission selectByUserIdAndPermissionId(@Param("userId") String userId, @Param("permissionId") String permissionId);
    
    /**
     * 检查用户是否有指定权限
     */
    boolean hasUserPermission(@Param("userId") String userId, @Param("permissionId") String permissionId);
    
    /**
     * 检查用户是否被授权指定权限
     */
    boolean isUserPermissionGranted(@Param("userId") String userId, @Param("permissionId") String permissionId);
    
    /**
     * 查询用户的权限ID列表
     */
    List<String> selectPermissionIdsByUserId(@Param("userId") String userId);
    
    /**
     * 查询用户的已授权权限ID列表
     */
    List<String> selectGrantedPermissionIdsByUserId(@Param("userId") String userId);
    
    /**
     * 查询用户的有效权限ID列表（未过期且已授权）
     */
    List<String> selectValidPermissionIdsByUserId(@Param("userId") String userId);
    
    /**
     * 查询权限的用户ID列表
     */
    List<String> selectUserIdsByPermissionId(@Param("permissionId") String permissionId);
    
    /**
     * 查询所有用户权限关联
     */
    List<UserPermission> selectAll();
    
    /**
     * 根据授权人查询关联列表
     */
    List<UserPermission> selectByGrantedBy(@Param("grantedBy") String grantedBy);
    
    /**
     * 根据授权时间范围查询关联列表
     */
    List<UserPermission> selectByGrantedTimeRange(@Param("startTime") LocalDateTime startTime, 
                                                  @Param("endTime") LocalDateTime endTime);
    
    /**
     * 根据授权状态查询关联列表
     */
    List<UserPermission> selectByGranted(@Param("granted") Boolean granted);
    
    /**
     * 查询临时权限列表
     */
    List<UserPermission> selectTemporaryPermissions(@Param("userId") String userId);
    
    /**
     * 查询过期权限列表
     */
    List<UserPermission> selectExpiredPermissions();
    
    /**
     * 查询即将过期的权限列表
     */
    List<UserPermission> selectExpiringPermissions(@Param("days") Integer days);
    
    /**
     * 插入用户权限
     */
    int insert(UserPermission userPermission);
    
    /**
     * 批量插入用户权限
     */
    int insertBatch(@Param("userPermissions") List<UserPermission> userPermissions);
    
    /**
     * 根据ID更新用户权限
     */
    int updateById(UserPermission userPermission);
    
    /**
     * 更新授权状态
     */
    int updateGrantedStatus(@Param("userId") String userId, 
                           @Param("permissionId") String permissionId, 
                           @Param("granted") Boolean granted);
    
    /**
     * 更新过期时间
     */
    int updateExpiresAt(@Param("id") String id, @Param("expiresAt") LocalDateTime expiresAt);
    
    /**
     * 根据ID删除用户权限
     */
    int deleteById(@Param("id") String id);
    
    /**
     * 删除用户权限关联
     */
    int deleteByUserIdAndPermissionId(@Param("userId") String userId, @Param("permissionId") String permissionId);
    
    /**
     * 根据用户ID删除所有权限关联
     */
    int deleteByUserId(@Param("userId") String userId);
    
    /**
     * 根据权限ID删除所有用户关联
     */
    int deleteByPermissionId(@Param("permissionId") String permissionId);
    
    /**
     * 删除过期权限
     */
    int deleteExpiredPermissions();
    
    /**
     * 批量删除用户权限
     */
    int deleteBatch(@Param("ids") List<String> ids);
    
    /**
     * 查询用户权限总数
     */
    Long selectCount();
    
    /**
     * 查询指定用户的权限数量
     */
    Long selectUserPermissionCount(@Param("userId") String userId);
    
    /**
     * 查询指定权限的用户数量
     */
    Long selectPermissionUserCount(@Param("permissionId") String permissionId);
    
    /**
     * 查询临时权限数量
     */
    Long selectTemporaryPermissionCount();
    
    /**
     * 查询过期权限数量
     */
    Long selectExpiredPermissionCount();
    
    /**
     * 查询权限分布统计
     */
    List<Map<String, Object>> selectPermissionDistributionStats();
    
    /**
     * 查询用户权限统计
     */
    List<Map<String, Object>> selectUserPermissionStats();
    
    /**
     * 查询最近授权的权限
     */
    List<UserPermission> selectRecentGranted(@Param("limit") Integer limit);
    
    /**
     * 查询指定时间段内的权限授权记录
     */
    List<UserPermission> selectGrantedInPeriod(@Param("startTime") LocalDateTime startTime,
                                               @Param("endTime") LocalDateTime endTime);
    
    /**
     * 查询没有特殊权限的用户列表
     */
    List<String> selectUsersWithoutSpecialPermission();
    
    /**
     * 查询没有用户的权限列表
     */
    List<String> selectPermissionsWithoutUser();
    
    /**
     * 查询用户权限变更历史
     */
    List<Map<String, Object>> selectUserPermissionHistory(@Param("userId") String userId);
    
    /**
     * 查询权限授权者统计
     */
    List<Map<String, Object>> selectGranterStats();
    
    /**
     * 批量更新用户权限
     */
    int batchUpdateUserPermissions(@Param("userId") String userId, 
                                  @Param("permissionIds") List<String> permissionIds,
                                  @Param("granted") Boolean granted,
                                  @Param("grantedBy") String grantedBy,
                                  @Param("grantedByName") String grantedByName,
                                  @Param("reason") String reason);
    
    /**
     * 检查权限授权冲突
     */
    List<Map<String, Object>> checkPermissionConflicts(@Param("userId") String userId, 
                                                       @Param("permissionIds") List<String> permissionIds);
    
    /**
     * 查询用户的权限继承链
     */
    List<Map<String, Object>> selectUserPermissionChain(@Param("userId") String userId);
    
    /**
     * 查询权限使用频率统计
     */
    List<Map<String, Object>> selectPermissionUsageStats(@Param("startTime") LocalDateTime startTime,
                                                         @Param("endTime") LocalDateTime endTime);
    
    /**
     * 清理过期权限
     */
    int cleanupExpiredPermissions();
}